home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / othernet / fidonet / msgcpy20 / msgcopy.doc < prev    next >
Text File  |  1995-04-27  |  6KB  |  150 lines
  1. Msgcopy is a utility to copy/move messages from one base to another
  2. it can change the from: & to: name of the user and also the destination
  3. network address , you can also append text to the beginning of a message
  4. being processed.
  5.  
  6. You can tell msgcopy to only test messages reaching certain conditions ,
  7. these conditions are from name , to name , subject text or evan message
  8. text.
  9.  
  10. I currently use msgcopy to take several internet email lists , copying the
  11. messages to the relevant echomail base on my BBS and putting the replies
  12. back into email to send them on their merry way , with an internet destination
  13. appended to the start of the message so Stuffit can process the message.
  14.  
  15. Any copied/moved message is marked as a LOCAL message , this along with 
  16. the update of the messages timestamp , ensures all the copied/moved mail 
  17. can be re-exported should you wish to do so.
  18.  
  19. You run Msgcopy by passing it a parameter , this can be 
  20.  
  21. 1) SCAN , This updates all the message pointers put doesn't export/import
  22.           any messages , I suggest you use this when you first start a new
  23.           base , make sure you have exported all your messages before adding
  24.           a new base otherwise they may be missed.
  25.  
  26. 2) MACRO, This will run the commands listed under that Macro in the
  27.           msgcopy.CFG file , see below for details , you can put either a
  28.           full macro name or a partial one , if a partial one is used then
  29.           any macro starting with that piece of text will be run.
  30.           e.g. , you can have EXPORT.GEMLIST and EXPORT.JAGUAR.LIST as
  31.           macros , runnning MSGCOPY.TTP EXPORT. will run both sets of these
  32.           macro commands.
  33.           
  34. 3) ALL ,     |This will run ALL macros listed in the msgcopy.CFG file in the
  35.    or no     |order they appear in.
  36.    parameter |
  37.  
  38. MsgCopy Configuration commands
  39. ==============================
  40.  
  41. All Macro Labels start wlth #<macro name> and the macro end should be just
  42. a # symbol on it's own , running msgcopy with the parameter ALL or no
  43. parameter will run all available macros as they are listed by the
  44. .CFG file.
  45.  
  46. FROM=<message base path and name (No ext.)>
  47.  
  48.      Informs MSGCOPY which base you want to read from.
  49.  
  50. TO=<message base path and name (No ext.)>
  51.  
  52.      Informs MSGCOPY which base you want to write to , leave this line out
  53.      if you only want to kill messages from a particular user or containing
  54.      a particular piece of text.
  55.      
  56. STATE=<type>
  57.      
  58.      Three states are available COPY, MOVE and KILL , they are pretty self
  59.      explanitory.
  60.  
  61. IF.TO=<text>
  62.  
  63.      The name given in the text after the command will be tested
  64.      against the To: name in the message header , if matched then action
  65.      will be taken on this message.
  66.  
  67.      Case is not important
  68.  
  69. IF.FROM=<text>
  70.  
  71.      The name given in the text after the command will be tested
  72.      against the from: name in the message header , if matched then action
  73.      will be taken on this message.
  74.  
  75.      Case is not important
  76.  
  77. IF.SUBJECT=<text>
  78.  
  79.      The text given in the text after the command will be tested
  80.      against the subject in the message header , if matched then action
  81.      will be taken on this message.
  82.  
  83.      Case is not important
  84.  
  85. IF.TEXT=<text>
  86.  
  87.      The text given in the text after the command will be tested
  88.      against the message in the message file , if matched then action
  89.      will be taken on this message.
  90.  
  91.      Case is not important
  92.      
  93. UPDATE.FROM.INDEX
  94.  
  95.       The .HDR file of the message base being read will be flagged as
  96.       read to stop messages already scanned being re-read.
  97.       
  98. UPDATE.TO.INDEX
  99.  
  100.       The .HDR file of the message base being written to will be flagged as
  101.       read to stop messages already scanned being re-read.
  102.       
  103. UPDATE.BOTH.INDEX
  104.  
  105.       The .HDR file of the message base being written and ALSO the one
  106.       being read will flagged as read to stop messages already scanned being
  107.       re-read.
  108.  
  109. The Above 3 commands might seem redundant , surely you would always want the
  110. index files to be upto-date for BOTH message bases , in MOST cases yes you
  111. would be right.
  112.  
  113. BUT , in two cases you might want the base to be re-scanned , for instance
  114. you may want to re-copy certain messages copied into the GEMLIST echo on
  115. your system for example , into a seperate echo if they contain a subject or
  116. text item you are specifically interested in , so in this case you will only
  117. want to update the FROM index or you may want to copy messages from the 1st
  118. destination echo into still another destination echo so you would want to
  119. only update the FROM index.
  120.  
  121. As long as you update BOTH the message areas index files using your last
  122. copy/move macro for that area then all will work fine, forgetting to do this
  123. may cause messages to be re-copied again next time.
  124.  
  125. HEADERTEXT
  126.  
  127.      Any Text Following this command will be added to the top of the message
  128.      being copied or moved.
  129.  
  130.      You can use the sub-macro @user.from in the text , this will take the
  131.      user's name that wrote the original message and insert it in the text.
  132.  
  133. TEXTEND
  134.  
  135.      This marks the end of the text above
  136.  
  137. ADDRESS.TO=<address>
  138.  
  139.       This redirects the To: address in the message header to that address.
  140.       
  141. NAME.TO=<name>
  142.  
  143.       This Changes the To: name in the message header to be that name
  144.  
  145. KILLSENT
  146.  
  147.       Used with the EMAIL option this forces the Killsent flag to be set 
  148.       so mail will be deleted when the mail tosser scans/packs the base.
  149.       
  150.